Voltar ao Painel

Documentação

Aprenda a usar o Asyntai

Integração com Discord

Connect Asyntai AI to your Discord server for automated responses and moderation

Conectar Discord

Visão Geral

Asyntai's Discord integration adds an AI-powered bot to your Discord server. Community members can ask questions and get instant answers from your knowledge base. The bot supports three response modes and optional AI moderation.

Requisito de Plano: Discord integration is available on Starter, Standard, and Pro plans.

Como Instalar

Follow these steps to add the Asyntai bot to your Discord server:

1

Add the Bot to Your Server

Acesse a página de configuração do Discord e clique em "Adicionar ao Discord". Selecione seu servidor e clique em Autorizar. O bot fica pronto instantaneamente — sem configuração adicional. Você pode adicionar o bot a vários servidores — basta clicar em "Adicionar ao Discord" novamente. Cada servidor tem suas próprias configurações.

2

Choose a Response Mode

After connecting, select how the bot interacts with your community:

- @mention (default) — The bot responds when someone tags it. Best for servers where you want the bot available but not intrusive.

- Todas as mensagens — A IA lê cada mensagem e decide se deve responder. Ideal para canais de suporte dedicados. Inclui opções adicionais:

- Modo inteligente (ativado por padrão) — A IA usa seu julgamento para pular conversa casual e só responde quando pode ajudar. Desativado, o bot responde a cada mensagem.

- Contexto do canal — A IA vê toda a conversa do canal de todos os usuários, não apenas threads individuais. Isso permite acompanhar discussões em grupo e responder no contexto.

- /ask command — Users type /ask followed by their question. Best for large servers where you want explicit bot interaction.

You can change the mode at any time from the setup page.

3

Test It Out

Go to any channel in your Discord server and tag the bot or use the /ask command. You should receive an AI-powered response within seconds.

Moderação IA

The Discord bot can also moderate your server. When enabled, the AI reads every message and takes action based on rules you define. Each action can be independently enabled:

Nota: Cada verificação de moderação conta como 1 mensagem da cota mensal do seu plano, mesmo que a IA não tome nenhuma ação.

- Delete messages — Remove messages that violate your rules (spam, NSFW, etc.)

- Warn users — Send a visible warning for minor violations

- Kick users — Remove users from the server for repeated violations

- Ban users — Permanently ban users for severe violations

Moderation runs independently of the response mode. Even in /ask-only mode, moderation still monitors every message.

Todas as ações de moderação são registradas e visíveis na página Registro de moderação, acessível pela página de configuração. Você pode ver qual ação foi tomada, o motivo, a mensagem original e quando aconteceu.

Dica: Start with Delete only, and add stronger actions once you are confident in the rules. The AI errs on the side of caution — when in doubt, it takes no action.

Mensagens proativas

O bot pode iniciar conversas por conta própria publicando mensagens AI em um cronograma. Ative na página de configuração e configure:

- Nome do canal — Em qual canal o bot publica (ex. general, support)

- Frequência — Com que frequência: a cada 2, 4, 6, 12 horas, diariamente, a cada 2 dias ou semanalmente

- Tópicos — Sobre o que o bot deve falar. A IA gera uma mensagem fresca e única cada vez com base nos seus tópicos.

Each proactive message counts as 1 message toward your plan quota.

Dica: Use mensagens proativas para compartilhar dicas, destacar recursos ou manter sua comunidade engajada — mesmo quando ninguém está perguntando.

Como funciona

Once connected, here is what happens:

1. A community member sends a message in your Discord server

2. If moderation is enabled, the AI evaluates the message against your rules

3. If a response is triggered (by @mention, /ask, or all-messages mode), the AI generates an answer using your knowledge base

4. The response is sent in the channel, and the conversation is logged in your Asyntai dashboard

The AI maintains conversation context per user, so follow-up questions are understood in relation to previous messages.

Monitoramento em Tempo Real & Intervenção Humana

Discord conversations appear in your Asyntai dashboard alongside other channels. On Standard and Pro plans, you can:

- Live Monitoring — See active Discord conversations in real time from the monitoring dashboard

- Human Takeover — Take over from the AI when a human touch is needed. The AI pauses and resumes automatically after 3 minutes of agent inactivity.

- Escalation — The AI can detect when a user wants to speak to a human and notify you by email

Advanced: Custom Bot Setup

If you prefer to use your own Discord Application instead of the shared Asyntai bot, expand the manual setup section on the setup page and provide your Application ID, Public Key, and Bot Token.

You will also need to set the Interactions Endpoint URL to https://asyntai.com/discord/webhook/ in the Discord Developer Portal.

Preços

Discord integration is included in paid Asyntai plans:

- Starter ($39/mês) - 2.500 mensagens/mês

- Standard ($139/mês) - 15.000 mensagens/mês

- Pro ($449/mês) - 50.000 mensagens/mês

Messages from Discord count toward your monthly message quota, shared across all channels (widget, Instagram, WhatsApp, etc.).

Solução de Problemas

Bot not responding

Check that the bot is online in your server member list. If using @mention or all-messages mode, the Gateway bot process must be running. If using /ask only, make sure the Interactions Endpoint URL is set in the Discord Developer Portal.

Moderation not working

Ensure moderation is enabled on the setup page with at least one action toggled on and rules filled in. The bot also needs Manage Messages, Kick Members, or Ban Members permissions depending on the action.

Missing permissions

If the bot cannot delete messages or kick/ban users, check that its role in Discord has the necessary permissions and is positioned above the roles of the users it needs to moderate.

Bot shows offline

The @mention and all-messages modes require the Gateway bot process to be running. Start it with python manage.py discord_bot and ensure it stays running as a background service. The /ask slash command works without the Gateway process.

Precisa de Ajuda?

Se você tiver dúvidas ou encontrar problemas, entre em contato conosco em hello@asyntai.com.